perm filename INFO.REM[UP,DOC] blob sn#560453 filedate 1981-02-05 generic text, type T, neo UTF8
	PRELIMINARY WRITEUP ON THE PROGRAMMED-TEXT FOLLOWER
	PRELIMINARY WRITEUP ON THE PROGRAMMED-TEXT FOLLOWER
	PRELIMINARY WRITEUP ON THE PROGRAMMED-TEXT FOLLOWER
	PRELIMINARY WRITEUP ON THE PROGRAMMED-TEXT FOLLOWER
	PRELIMINARY WRITEUP ON THE PROGRAMMED-TEXT FOLLOWER
	PRELIMINARY WRITEUP ON THE PROGRAMMED-TEXT FOLLOWER
	PRELIMINARY WRITEUP ON THE PROGRAMMED-TEXT FOLLOWER
	PRELIMINARY WRITEUP ON THE PROGRAMMED-TEXT FOLLOWER
	PRELIMINARY WRITEUP ON THE PROGRAMMED-TEXT FOLLOWER
	PRELIMINARY WRITEUP ON THE PROGRAMMED-TEXT FOLLOWER
	PRELIMINARY WRITEUP ON THE PROGRAMMED-TEXT FOLLOWER
	PRELIMINARY WRITEUP ON THE PROGRAMMED-TEXT FOLLOWER
	PRELIMINARY WRITEUP ON THE PROGRAMMED-TEXT FOLLOWER
	OTHERWISE KNOWN AS THE REM INFORMATION SYSTEM
		-- ROBERT ELTON MAAS

//ANYTHING SAID HERE IS LIABLE TO CHANGE, SEE THE FILE ISR[S,REM] FOR
EXAMPLES OF CORRECT FORMAT FOR PROGRAMMED-TEXT FILES//

	This program is currently INFO.DMP[1,3] and ISRT.SAI[S,REM].
It provides an interface between a user and a programmed text file,
as well as providing other kludge-features such as automatically
reading other files on the disk and running jobs through a PTY.
	PRELIMINARY WRITEUP ON THE PROGRAMMED-TEXT FOLLOWER
	The programmed text is by default ISR[S,REM] but may be
specified as any other file by putting a semicolon in the command
line, followed by the file name.  The location of the initial frame
of the programmed text is 00100/3 by default, but may be specified
as any other by following the file name by a double-arrow "↔" then
the sos command such as P100/4 or whatever.  Dollar sign is converted
to altmode if you include it (I think).  Currently, the only other
file I know of on the disk that is in correct format for input
to this program is TRIVIA.ISR[2,TVR].
	Here is the format required for the programmed text.  Look
at ISR[S,REM] if you can't read my version of BNF.
	∞[<FOO>] ← any number of <FOO> items, perhaps none
	[<FOO>] ← one or zero <FOO> items
	"h" ← the character "h"
	& ← concatination operator
	/ (separates your choices)

	<TREE> ← <TOPFRAME> & ∞[<FRAME>]
	<TOPFRAME> ← <FRAME> (the one pointed at by the initial SOS command
	<FRAME> ← "∨FRAME" & <ID> & ":" & <TEXT> & <COMMANDSTR> &
	  ∞[<TEXT> & <COMMANDSTR>] & [<CRLF>] & ";" & [<ANYTEXT>]
	<ID> ← any string of upper-case letters and numbers not containing "E"
	<TEXT> ← any text not containing ":" or ";" or "(" or ")"
	<ANYTEXT> ← any text not containing any "FRAME"&<ID> or <COMMAND>
	<COMMANDSTR> ← "(" & <COMMAND> & ")"
	<COMMAND> ← <FCOM> / <PCOM> / <εCOM> / <@COM> / <!COM> /
	  <.COM> / <ECOM>
	<FCOM> ← "FE≡" & <ID> & ":$" (where <ID> refers to a future frame)
	<PCOM> ← <any SOS print line command such as "P100/4")
	<εCOM> ← "ε"
	<@COM> ← "@" & <FILNAM.EXT[P,P]>
	<!COM> ← "!" & <FILNAM.EXT[P,P]> & ["↔" & <SOS COMMAND>]
	<.COM> ← "." & <SYSTEM COMMAND>  (such as "R TV;FOO/N←TEACH[1,DCS]")
	<ECOM> ← "E"

	Here is an explanation of the commands:  FCOM and PCOM find the
first line of another frame.  εCOM signals the keyword kludge which
lets the user type keyword(s) and jump to an appropriate location in
the tree without following the path of frame links to get there.
@COM causes an external file to be read from the disk.  !COM causes
the program to initialize itself on another programmed text.
.COM types that command into a PTY or into your TTY before exiting.
ECOM causes the program to exit.  A look at ISR[S,REM] will show
examples of all these commands, and running the program with default
file name will demonstrate the action caused by the commands, in case
this writeup is not clear.
	During the course of running, various messages are generated
regarding errors in the programmed-text and missing files on the disk,
as well as various statistics about usage of the program.
These are called <JOB NUMBER> & "LI.NEW" and are located on the [1,REM]
disk area or on the area where the programmed text resides.
If you create a programmed-text on your area, you should be prepared
to look at these files and clean them up every day or so.
	Recommendations for information to be put in this writeup
should be directed to REM, as should questions that may arise.
The experts who may be able to answer questions about the program
are REM and TVR.